Inside Macintosh: QuickDraw GX Printing /

Chapter 2 - Core Printing Features / Core Printing Features Reference

Functions / Printing With QuickDraw GX

GXFinishJob

You can use the GXFinishJob function to notify QuickDraw GX that printing is complete.

void GXFinishJob (gxJob aJob);

aJob

A reference to the job object being printed.

DESCRIPTION

The GXFinishJob function completes the application phase of printing. You should call this function after you have called the GXPrintPage function to print each page in a document.

SPECIAL CONSIDERATIONS

You should only call the GXFinishJob function if the GXStartJob function doesn't return errors.

RESULT CODES

gxPrUserAbortErr	The user has canceled printing.
gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.

In addition to the result codes listed above, you may also receive errors that can occur while flattening graphics objects during spooling. Flattening graphics objects is described in the shape objects chapter of Inside Macintosh: GX Objects.

SEE ALSO

Listing 2-5 on page 2-21 and Listing 2-6 on page 2-23 show how to use the GXFinishJob function to tell QuickDraw GX that the document is ready to be queued for printing in the background.

The GXStartJob function is described on page 2-63.

Phases of printing are described in the chapter "Introduction to Printing With QuickDraw GX" in this book.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help